CAMEL-23236: Improve beginner UX with interactive init, examples, doctor, and contextual help#22211
CAMEL-23236: Improve beginner UX with interactive init, examples, doctor, and contextual help#22211gnodet wants to merge 1 commit into
Conversation
|
🌟 Thank you for your contribution to the Apache Camel project! 🌟 🐫 Apache Camel Committers, please review the following items:
|
|
🧪 CI tested the following changed modules:
💡 Manual integration tests recommended:
All tested modules (6 modules)
|
|
🧪 CI tested the following changed modules:
All tested modules (26 modules)
|
…tor, and contextual help - Add interactive template picker to camel init (--list flag, arrow-key selection) - Add camel run --example for zero-to-running experience with bundled examples - Add camel doctor diagnostic command for environment/dependency checks - Extend did-you-mean suggestions to more commands in CatalogBaseCommand - Add context-aware shell banner (detects route files, shows quick-start hints) - Improve Camel-Kit discoverability (add KIT plugin type) - Include bundled example route files (timer-log, cron-log, rest-api) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
|
@gnodet can you fix the merge conflict and rebase thank you |
|
I like the doctor command. However Java 17 is still possible to use (but we recommend java 21 or 25). So the doctor can then say that if java 17 is detected then recommend to use java 21 or better. |
CAMEL-23236
Summary
Improve the beginner UX for Camel JBang by adding several features that help new users get started quickly:
inittemplate picker:camel init --listpresents an arrow-key selectable menu of available archetypes/templatesrun --example: Bundled example routes (timer-log, cron-log, rest-api) that users can run immediately without creating filesdoctorcommand: Diagnostic command that checks environment setup (Java version, Maven, Docker/Podman, etc.) and reports issueskitplugin for AI-assisted project scaffoldingTest plan
camel init --listshows interactive template pickercamel run --example timer-logruns bundled examplecamel doctorreports environment diagnosticscamel shellshows context-aware banner (with/without route files present)